X-MimeOLE: Produced By Microsoft Exchange V6.5
Received: by onstor-exch02.onstor.net 
	id <01C773D3.7CFE1890@onstor-exch02.onstor.net>; Sat, 31 Mar 2007 13:30:57 -0700
MIME-Version: 1.0
Content-Type: multipart/alternative;
	boundary="----_=_NextPart_001_01C773D3.7CFE1890"
Content-class: urn:content-classes:message
Subject: Document for meeting: Proposed Solution to upgrade failing, defect # 17907
Date: Sat, 31 Mar 2007 13:30:57 -0700
Message-ID: <BB375AF679D4A34E9CA8DFA650E2B04E022156E7@onstor-exch02.onstor.net>
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
Thread-Topic: Document for meeting: Proposed Solution to upgrade failing, defect # 17907
Thread-Index: AcdzN/aLnDPyQjlwTEKRflFdC5Pi+gAmwKsg
From: "Larry Scheer" <larry.scheer@onstor.com>
To: "dl-Design Review" <dl-designreview@onstor.com>

This is a multi-part message in MIME format.

------_=_NextPart_001_01C773D3.7CFE1890
Content-Type: text/plain;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

Proposed Solution to upgrade failing, defect # 17907

Summary:
The changes made to the upgrade program for Lamborghini contain four
major components.=20
1.	The upgrade command (cmd_upgrade.c)
2.	The installation script (verify_install.sh)
3.	A generated manifest file (aka .bom) to verify file integrity
and contents of the installation on the flash
4.	The distribution tar file.

When an upgrade is run it uses the nfx shell and verify_install.sh that
are installed on the flash in /usr/local/agile/bin and the manifest file
that is stored in the distribution tar file. The manifest file and
verify_install.sh ultimately determine what will be installed on a
compact flash from the distribution. The upgrade command performs pre
and post installation tasks.=20

By design the verify_install.sh script is closely coupled with the
manifest file for a release and less dependent upon features and
behaviors of cmd_upgrade.c. If necessary verify_install.sh can be made
to be a standalone installation program to work with the distribution
and its manifest file.

The issue:
The main issue is any new enhancement or corrections to the upgrade
program currently take two installs before any benefit, fix, or
corrections are seen. The old upgrade commands are installing the new
upgrade program. Fixing installation defects are problematic.

Case study:
In the Delorean release new libraries were added which called for new
symbolic links. The previous installation did not take into account
adding new symbolic links. The installation script and manifest files
were modified to accommodate the changes. The old installation script,
which will install this release, is not 100% compatible with the changes
made to the manifest file. The side effect of this incompatibility is
every file on the distribution will be marked as needing an upgrade.
This in turn leads to very long installation cycles. It also exposed a
bug in the cheetah where the system silently reboots before the
installation is complete.=20

If the new verify_install.sh file is copied to /usr/ocal/agile/bin the
installation complete in an expected amount of time and cheetah systems
can be upgraded.

Proposed Solution:
Modify cmd_upgrade to unpack verify_install.sh into the memory
filesystem and run that version of the installation script versus the
one installed on the compact flash.=20

This will decouple the installation process from the pre and post
install processes. It allows for fixes and enhancements to be made to
the installation processes without requiring a multiple installations,
after the intial Delorean install, of course.



------_=_NextPart_001_01C773D3.7CFE1890
Content-Type: text/html;
	charset="us-ascii"
Content-Transfer-Encoding: quoted-printable

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV=3D"Content-Type" CONTENT=3D"text/html; =
charset=3Dus-ascii">
<META NAME=3D"Generator" CONTENT=3D"MS Exchange Server version =
6.5.7651.59">
<TITLE>Document for meeting: Proposed Solution to upgrade failing, =
defect # 17907</TITLE>
</HEAD>
<BODY>
<!-- Converted from text/rtf format -->

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><B><FONT FACE=3D"Arial">Proposed =
Solution to upgrade failing, defect # 17907</FONT></B></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><B><FONT SIZE=3D2 =
FACE=3D"Arial">Summary:</FONT></B></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">The =
changes made to the upgrade program for Lamborghini contain four major =
components. </FONT></SPAN></P>

<P><SPAN LANG=3D"en-us"><FONT SIZE=3D2 =
FACE=3D"Arial">1.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT></SPAN><SPAN =
LANG=3D"en-us"></SPAN><SPAN LANG=3D"en-us"></SPAN><SPAN LANG=3D"en-us"> =
<FONT SIZE=3D2 FACE=3D"Arial">The upgrade command =
(cmd_upgrade.c)</FONT></SPAN>

<BR><SPAN LANG=3D"en-us"><FONT SIZE=3D2 =
FACE=3D"Arial">2.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT> <FONT SIZE=3D2 =
FACE=3D"Arial">The installation script (verify_install.sh)</FONT></SPAN>

<BR><SPAN LANG=3D"en-us"><FONT SIZE=3D2 =
FACE=3D"Arial">3.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT> <FONT SIZE=3D2 =
FACE=3D"Arial">A generated manifest file (aka .bom) to verify file =
integrity and contents of the installation on the flash</FONT></SPAN>

<BR><SPAN LANG=3D"en-us"><FONT SIZE=3D2 =
FACE=3D"Arial">4.&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</FONT> <FONT SIZE=3D2 =
FACE=3D"Arial">The distribution tar file.</FONT></SPAN>
</P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">When =
an upgrade is run it uses the nfx shell and verify_install.sh that are =
installed on the flash in /usr/local/agile/bin and the manifest file =
that is stored in the distribution tar file. The manifest file and =
verify_install.sh ultimately determine what will be installed on a =
compact flash from the distribution. The upgrade command performs pre =
and post installation tasks. </FONT></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">By =
design the verify_install.sh script is closely coupled with the manifest =
file for a release and less dependent upon features and behaviors of =
cmd_upgrade.c. If necessary verify_install.sh can be made to be a =
standalone installation program to work with the distribution and its =
manifest file.</FONT></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><B><FONT SIZE=3D2 =
FACE=3D"Arial">The issue:</FONT></B></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">The =
main issue is any new enhancement or corrections to the upgrade program =
currently take two installs before any benefit, fix, or corrections are =
seen. The old upgrade commands are installing the new upgrade program. =
Fixing installation defects are problematic.</FONT></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><B><FONT SIZE=3D2 =
FACE=3D"Arial">Case study:</FONT></B></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">In =
the Delorean release new libraries were added which called for new =
symbolic links. The previous installation did not take into account =
adding new symbolic links. The installation script and manifest files =
were modified to accommodate the changes. The old installation script, =
which will install this release, is not 100% compatible with the changes =
made to the manifest file. The side effect of this incompatibility is =
every file on the distribution will be marked as needing an upgrade. =
This in turn leads to very long installation cycles. It also exposed a =
bug in the cheetah where the system silently reboots before the =
installation is complete. </FONT></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">If =
the new verify_install.sh file is copied to /usr/ocal/agile/bin the =
installation complete in an expected amount of time and cheetah systems =
can be upgraded.</FONT></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><B><FONT SIZE=3D2 =
FACE=3D"Arial">Proposed Solution:</FONT></B></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 =
FACE=3D"Arial">Modify cmd_upgrade to unpack verify_install.sh into the =
memory filesystem and run that version of the installation script versus =
the one installed on the compact flash. </FONT></SPAN></P>

<P ALIGN=3DLEFT><SPAN LANG=3D"en-us"><FONT SIZE=3D2 FACE=3D"Arial">This =
will decouple the installation process from the pre and post install =
processes. It allows for fixes and enhancements to be made to the =
installation processes without requiring a multiple installations, after =
the intial Delorean install, of course.</FONT></SPAN></P>
<BR>

</BODY>
</HTML>
------_=_NextPart_001_01C773D3.7CFE1890--
